home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / jmd4tlx.zip / JXFER.DOC < prev    next >
Text File  |  1989-03-20  |  15KB  |  382 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                      ENHANCED JMODEM FILE TRANSFERS
  28.  
  29.                                  using
  30.  
  31.                         THE TELIX SALT LANGUAGE
  32.  
  33.                                    by
  34.  
  35.                           Michael K. Bozovich
  36.  
  37.                                 03/20/89
  38.  
  39.  
  40.  
  41.  
  42.  
  43.     -----PHILOSOPHY------------------------------------------------------
  44.  
  45.  
  46.     When I first began using the Jmodem protocol, I was blown away!
  47.     I had been using Zmodem and thought that there was no way to beat
  48.     it's file transfer rate.  At the same time, I was dismayed by the
  49.     limitation of one file per transfer.  After considering this dilemma,
  50.     I set out to to enhance the capabilities of the basic Jmodem driver
  51.     in the hopes that the use of this advanced protocol would become
  52.     widespread.  This set of scripts is at least a step in the right
  53.     direction. . .
  54.  
  55.  
  56.     This set of TELIX 3.11 script files will allow the seamless (almost)
  57.     integration of the JMODEM protocol into the TELIX program.
  58.  
  59.  
  60.  
  61.  
  62.     -----PROGRAMS--------------------------------------------------------
  63.  
  64.  
  65.  
  66.     The files in this package should consist of:
  67.  
  68.  
  69.           JXFER.DOC          // These instructions.
  70.  
  71.           JUP.SLT            // Source code for the upload stub.
  72.           JUP.SLC            // Compiled upload stub.
  73.  
  74.           JDOWN.SLT          // Source code for the download stub.
  75.           JDOWN.SLC          // Compiled download stub.
  76.  
  77.           JXFER.SLT          // Source code for the "inner workings".
  78.           JXFER.SLC          // Compiled "inner workings".
  79.  
  80.           JSIZE.C            // Source code for the "kludge".
  81.           JSIZE.EXE          // Compiled "kludge".
  82.  
  83.           JMODEM.COM         // The Jmodem driver.
  84.           JMODEM.DOC         // The Jmodem Documentation.
  85.  
  86.  
  87.  
  88.  
  89.     -----INSTALLATION----------------------------------------------------
  90.  
  91.  
  92.     A. The first step in integrating Jmodem is to tell TELIX the following
  93.        in the "File transfer protocols" Setup screen:
  94.  
  95.           1.  Key               -  Whatever you like. (I use "J".)
  96.           2.  Protocol Name     - "Jmodem"
  97.           3.  Upload Filename   - "JUP"
  98.           4.  Download Filename - "JDOWN"
  99.           5.  BAT or Script     - "Script"
  100.           6.  DL Name           - "N"
  101.  
  102.  
  103.     Your screen should resemble this:
  104.  
  105.     ╒═╡ File transfer protocols ╞══════════════════════════════════════════╕
  106.     │                                                                      │
  107.     │ External           Key   Protocol    Upload   Download  BAT or   DL  │
  108.     │ Protocols                Name       Filename  Filename  Script  Name │
  109.     │                                                                      │
  110.     │ A.................  J    Jmodem        JUP    JDOWN     Script   N   │
  111.     │                                                                      │
  112.     │ B.................                                                   │
  113.     │                                                                      │
  114.  
  115.  
  116.  
  117.     B. The next step is making sure that all of the necessary files are where
  118.        they belong:
  119.  
  120.           1.  The following files belong in the "Script directory".
  121.               This is where you told TELIX to look for script files.
  122.               (Option "C" in the filename/path setup.)
  123.  
  124.                               JUP.SLC
  125.                               JDOWN.SLC
  126.                               JXFER.SLC
  127.  
  128.           2.  These files must reside somewhere in the DOS PATH.
  129.               If they are not there, don't say I didn't tell you!
  130.  
  131.                               JMODEM.COM
  132.                               JSIZE.EXE
  133.  
  134.  
  135.     C. That's all there is to it.  You can begin using JMODEM with
  136.        TELIX as though it came with the package!
  137.  
  138.  
  139.     -----USAGE-----------------------------------------------------------
  140.  
  141.     These script files provide much more versatility than the standard
  142.     "BATCH file" method of adding an external protocol.  These are some
  143.     points to consider:
  144.  
  145.           1.  UPLOAD -
  146.  
  147.               Although some BBS's don't support it (yet), for those that
  148.               do, you can now use JMODEM to Batch Upload as many filespecs
  149.               as you can fit in the "upload box".  You are free to use
  150.               wildcards as well.  All I ask (and the script file requires!),
  151.               is that you include ONE OR MORE SPACES between multiple
  152.               filespecs.
  153.  
  154.           2.  DOWNLOAD -
  155.  
  156.               Although TELIX doesn't allow multiple filespecs to be
  157.               entered in the "download box", the JDOWN script file
  158.               will accept them without a hitch.  This was accomplished
  159.               by supplying an emulation of the "download box".  This
  160.               WILL NOT WORK if you didn't tell TELIX to not prompt
  161.               for the download file name as instructed above!
  162.  
  163.               You MAY NOT use wildcards in your download filespecs.
  164.               If you attempt to do so, the script will gripe about
  165.               it and grind to a halt.  Sorry. I will include this
  166.               feature as soon as JMODEM recognizes the name of the
  167.               incoming file.
  168.  
  169.           3.  PERFORMANCE LOGGING -
  170.  
  171.               In addition to the features described above, this set
  172.               of scripts will create and maintain a log file of all
  173.               attempted JMODEM transfers.  If you have defined a
  174.               TELIX environment variable as described in the TELIX
  175.               documentation, the file will be placed there.  If not,
  176.               the file will be written indiscriminately to whatever
  177.               drive and subdirectory you happen to be in at the time.
  178.  
  179.               This file is named JMODEM.LOG (catchy, eh?), and is
  180.               based on the log file produced by the DSZ.COM program.
  181.  
  182.               Here is a sample:
  183.  
  184.                           TELIX JMODEM File Transfer Log
  185.  
  186.      S   7504   2400 bps      0 cps     17s 03-19-89 *ABORTED* \config.sys
  187.      R   8388   2400 bps    247 cps     34s 03-19-89 COMPLETED c:\dl\any.zip
  188.      S  15112   2400 bps      0 cps     17s 03-19-89 *ABORTED* a:\autoexec.bat
  189.      R  26796   2400 bps    245 cps    109s 03-19-89 COMPLETED f:\dl\foo.zip
  190.      R  18208   2400 bps    247 cps     74s 03-19-89 COMPLETED .\bar.zip
  191.  
  192.               - The first field indicates whether a (S)end or a (R)eceive
  193.                 was attempted.
  194.  
  195.               - The second field is the number of bytes transferred.
  196.  
  197.  
  198.               - The third field is the baud rate used for the transfer.
  199.  
  200.               - The fourth field is a measure of the approximate trans-
  201.                 fer speed in characters per second.  Actual transfer
  202.                 rates will be greater than those reported.  This rate
  203.                 is set to zero if the transfer was aborted.
  204.  
  205.               - The fifth field is an approximation of the transfer
  206.                 time in seconds.  Since this time includes the time
  207.                 required to load the JMODEM driver from disk, it's
  208.                 accuracy depends largly on the speed of the drive
  209.                 used.  Actual transfer times will be less than those
  210.                 reported.
  211.  
  212.               - Field six is the date the transfer was attempted.
  213.  
  214.               - Field seven indicates whether the transfer met
  215.                 with success.
  216.  
  217.               - Finally, field eight is the complete specification
  218.                 of the file involved.
  219.  
  220.           4.  PATH SUPPORT -
  221.  
  222.               The pathnames used in uploading/downloading work ex-
  223.               actly as described in the TELIX documentation.  Here
  224.               is a review:
  225.  
  226.               - If you specify a path in the filespec, the script
  227.                 will respect your wishes.
  228.  
  229.               - If you do not specify a path, the script will use
  230.                 the one you specified in 'setup'.
  231.  
  232.               - If you did not specify a path in 'setup' (shame!),
  233.                 the file will end up